home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds / sc.man < prev    next >
Text File  |  1992-05-27  |  57KB  |  2,293 lines
  1. .\" Warning:  The string "sc" is converted to the true program name
  2. .\" by the makefile, throughout this document.
  3. .\"
  4. .\" Warning:  The order of presentation of commands largely matches the
  5. .\" help screen built into the program.
  6. .\"
  7. .\" Conventions:
  8. .\" - sc italicized and never uppercased (it's a proper name).
  9. .\" - Refer to lists of commands in the same order as introduced.
  10. .\" - Command and function names bold when introduced, italicized in all
  11. .\"   other places if possible, or in `` '' if not.
  12. .\" - Cell names italicized except when used in expressions; row numbers
  13. .\"   and column names not italicized.
  14. .\" - Use `` '' rather than " " except referring to literal input or output.
  15. .\" - TPs use default indent except for function names, then 18.
  16. .\" - Smallify uppercase strings.
  17. .\" - Avoid passive voice and third person.
  18. .\" $Revision: 6.21 $
  19. .\"
  20. .TH SC\ 
  21.  
  22.  
  23.  
  24.  
  25.  
  26. 6.21\  1
  27. .SH NAME
  28. sc \- spreadsheet calculator
  29. .SH SYNOPSIS
  30. .B sc
  31. [
  32. .B -c
  33. ]
  34. [
  35. .B -m
  36. ]
  37. [
  38. .B -n
  39. ]
  40. [
  41. .B -r
  42. ]
  43. [
  44. .B -x
  45. ]
  46. [
  47. .I file
  48. ]
  49. .\" ==========
  50. .SH DESCRIPTION
  51. The spreadsheet calculator
  52. .I sc
  53. is based on rectangular tables much like a financial spreadsheet.
  54. When invoked it presents you with a table
  55. organized as rows and columns of cells.
  56. If invoked without a
  57. .I file
  58. argument, the table is initially empty.
  59. Otherwise
  60. .I file
  61. is read in (see the
  62. .I Get
  63. command below).
  64. Each cell may have associated with it
  65. a numeric value,
  66. a label string,
  67. and/or an expression (formula)
  68. which evaluates to a numeric value or label string,
  69. often based on other cell values.
  70. .LP
  71. For a on-line tutorial, type the command:
  72. .IP
  73. sc /sprite/lib/sc/tutorial.sc
  74. .LP
  75. To print a quick reference card, type the command:
  76. .IP
  77. scqref | [your_printer_commmand]
  78. .\" ----------
  79. .SH OPTIONS
  80. .\" ----------
  81. .TP
  82. .B \-c
  83. Start the program with the recalculation being done in column order.
  84. .\" ----------
  85. .TP
  86. .B \-m
  87. Start the program with automatic recalculation disabled.
  88. The spreadsheet will be recalculated only when the ``@'' command is used.
  89. .\" ----------
  90. .TP
  91. .B \-n
  92. Start the program in quick numeric entry mode (see below).
  93. .\" ----------
  94. .TP
  95. .B \-r
  96. Start the program with the recalculation being done in row
  97. order (default option).
  98. .\" ----------
  99. .TP
  100. .B \-x
  101. Cause the
  102. .I Get
  103. and
  104. .I Put
  105. commands (see below) to encrypt and decrypt data files.
  106. .\" ----------
  107. .TP
  108. .B \-R
  109. Start the program with automatic newline action set to increment the row
  110. (see below).
  111. .\" ----------
  112. .TP
  113. .B \-C
  114. Start the program with automatic newline action set to increment the column
  115. (see below).
  116. .\" ----------
  117. .PP
  118. All of these options can be changed with the
  119. .I ^T
  120. and 
  121. .I S
  122. commands (see below) while
  123. .I sc
  124. is running.  Options specified when
  125. .I sc 
  126. is invoked
  127. override options saved in the data file.
  128. .\" ==========
  129. .SS "General Information"
  130. .\" ----------
  131. The screen is divided into four regions.
  132. The top line is for entering commands and displaying cell values.
  133. The second line is for messages from
  134. .IR sc .
  135. The third line and the first four columns show the column and row numbers,
  136. from which are derived cell addresses, e.g.
  137. .I A0
  138. for the cell in column A, row 0.
  139. Note that column names are case-insensitive: you can enter
  140. .I A0
  141. or
  142. .IR a0 .
  143. .\" ----------
  144. .PP
  145. The rest of the screen forms a window looking at a portion of the table.
  146. The total number of display rows and columns available,
  147. hence the number of table rows and columns displayed,
  148. is set by
  149. .IR curses (3)
  150. and may be overridden by setting the
  151. .SM LINES
  152. and
  153. .SM COLUMNS
  154. environment variables, respectively.
  155. .\" ----------
  156. .PP
  157. The screen has two cursors:
  158. a cell cursor, indicated by a highlighted cell and a ``<'' on the screen,
  159. and a character cursor, indicated by the terminal's hardware cursor.
  160. The cell and character cursors are often the same.
  161. They differ when you type a command on the top line.
  162. .\" ----------
  163. .PP
  164. If a cell's numeric value is wider than the column width (see the
  165. .I f
  166. command), the cell is filled with asterisks.
  167. If a cell's label string is wider than the column width,
  168. it is truncated at the start of the next non-blank cell in the row, if any.
  169. .\" ----------
  170. .PP
  171. Cursor control commands and row and column commands
  172. can be prefixed by a numeric argument
  173. which indicates how many times the command is to be executed.
  174. You can type
  175. .I ^U
  176. before a repeat count if quick numeric entry mode is enabled
  177. or if the number is to be entered
  178. while the character cursor is on the top line.
  179. .\" ----------
  180. .PP
  181. Commands which use the terminal's control key, such as
  182. .IR ^N ,
  183. work both when a command is being typed and when in normal mode.
  184. .\" ==========
  185. .SS "Changing Options"
  186. .\" ----------
  187. \0 \" exactly one blank line (hard to get)
  188. .PD 0
  189. .TP
  190. .BI ^T o
  191. Toggle options.
  192. This command allows you to switch the state of one option selected by
  193. .IR o .
  194. A small menu lists the choices for
  195. .I o
  196. when you type
  197. .IR ^T .
  198. The options selected are saved when the data and formulas are saved
  199. so that you will have the same setup next time you enter the
  200. spreadsheet. 
  201. .PD
  202. .RS
  203. .\" ----------
  204. .TP
  205. .B a
  206. Automatic Recalculation.
  207. When set, each change in the spreadsheet causes the entire spreadsheet
  208. be recalculated.  Normally this is not noticeable, but for very large
  209. spreadsheets, it may be faster to clear automatic recalculation mode and
  210. update the spreadsheet via explicit ``@'' commands.  Default is 
  211. automatic recalculation on.
  212. .\" ----------
  213. .TP
  214. .B c
  215. Current cell highlighting.
  216. If enabled, the current cell is highlighted
  217. (using the terminal's standout mode, if available)
  218. in addition to being marked by the cell cursor.
  219. .\" ----------
  220. .TP
  221. .B e
  222. External function execution.
  223. When disabled, external functions (see
  224. .IR @ext ()
  225. below) are not called.
  226. This saves a lot of time at each screen update.
  227. External functions are disabled by default.
  228. If disabled, and external functions are used anywhere,
  229. a warning is printed each time the screen is updated,
  230. and the result of
  231. .IR @ext ()
  232. is the value from the previous call, if any, or a null string.
  233. .\" ----------
  234. .TP
  235. .B l
  236. Autolabeling.
  237. If enabled, using the define command (/d) causes a label
  238. to be automatically generated in the cell to the left of the
  239. defined cell.  This is only done if the cell to the left is empty.
  240. Default is enabled.
  241. .\" ----------
  242. .TP
  243. .B n
  244. Quick numeric entry.
  245. If enabled,
  246. a typed digit is assumed to be
  247. the start of a numeric value for the current cell,
  248. not a repeat count, unless preceded by
  249. .IR ^U .
  250. The cursor controls
  251. .RI ( ^P ,
  252. .IR ^N ,
  253. .IR ^B ,
  254. .IR ^F )
  255. in this mode will end a numeric entry.
  256. .\" ----------
  257. .TP
  258. .B t
  259. Top line display.
  260. If enabled,
  261. the name and value of the current cell is displayed on the top line.
  262. If there is an associated label string,
  263. the first character of the string value
  264. is ``|'' for a centered string, ``<'' for a leftstring or ``>'' for a rightstring (see below),
  265. followed by "\fIstring\fP" for a constant string
  266. or
  267. .RI { expr }
  268. for a string expression.
  269. A constant string may be preceeded with a backslash (`\\').
  270. In this case the constant string will be used as a ``wheel''
  271. to fill a column, e.g. "\\-" for a line in a column,
  272. and "\\Yeh\ " for "Yeh\ Yeh\ Ye".
  273. If the cell has a numeric value,
  274. it follows as
  275. .RI [ value ],
  276. which may be a constant or expression.
  277. .\" ----------
  278. .TP
  279. .B x
  280. Encryption.
  281. See the
  282. .B \-x
  283. option.
  284. .\" ----------
  285. .TP
  286. .B $
  287. Dollar prescale.
  288. If enabled, all numeric
  289. .B constants
  290. (not expressions) which you enter are multipled by 0.01
  291. so you don't have to keep typing the decimal point
  292. if you enter lots of dollar figures.
  293. .\" ----------
  294. .TP
  295. .B r
  296. Newline action.
  297. This option toggles between three cases.
  298. The default is no action.
  299. If this option is used once, after each command which is terminated
  300. by a newline character is completed, the current cell will be moved
  301. down one row.
  302. If this option is used again, after each command which is terminated
  303. by a newline character is completed, the current cell will be moved
  304. right one column.
  305. Another use of this option will restore the default action.
  306. .\" ----------
  307. .TP
  308. .B z
  309. Set newline action limits.
  310. This option sets limits to the newline action option above.
  311. When this option is invoked, the row and column of the current cell are
  312. remembered.
  313. If a later newline action would take the current cell to the right of
  314. the remembered column, then the current cell is instead moved to the
  315. first column of the next row.
  316. If a newline action would take the current cell below the remembered row,
  317. then the current cell is instead moved to the top row of the next column.
  318. .PP
  319. The quick numeric entry, newline action and set newline action limits options
  320. can be combined to allow very quick entry of large amounts of data.
  321. If all the data to be entered is in a single row or column then setting
  322. the quick numeric entry and the appropriate newline action will allow
  323. the numbers to be entered without any explicit commands to position the
  324. current cell or enter a number.
  325. .PP
  326. If the data entry involves several entries in each row for many rows, then
  327. setting the quick numeric entry option, setting the newline action to move
  328. right after each entry and setting the newline action limits on the last
  329. column on which data should be entered will allow the data to entered
  330. quickly.
  331. If necessary, columns which do not need data to be entered can be hidden with
  332. the
  333. .B z
  334. command.
  335. Similar arrangements can be made for entering several rows of data
  336. in each column.
  337. .RE
  338. .\" ----------
  339. \0 \" exactly one blank line (hard to get)
  340. .PD 0
  341. .TP
  342. .B S
  343. Set options.  This command allows you to set various options.
  344. A small menu lists the options that cannot be changed through
  345. .I ^T
  346. above.
  347. .PD
  348. .RS
  349. .TP
  350. .BR byrows /  bycols
  351. Specify the order cell evaluation when updating.  These options also affect
  352. the order in which cells are filled (see 
  353. .IR /f )
  354. and whether a row or column is cleared by an 
  355. .I x
  356. command.
  357. .TP
  358. .BI iterations =n
  359. Set the maximum number of recalculations before
  360. the screen is displayed again. 
  361. .I Iterations
  362. is set to 10 by default.
  363. .TP
  364. .BI tblstyle =s
  365. Control the output of the 
  366. .I T
  367. command.
  368. .I s
  369. can be:
  370. .B 0
  371. (default) to give colon delimited fields, with no 
  372. .I tbl
  373. control lines;
  374. .B tbl
  375. to give colon delimited fields, with
  376. .IR tbl (1)
  377. control lines;
  378. .B latex
  379. to give a
  380. .I LaTeX
  381. tabular environment; 
  382. .B slatex
  383. to give a
  384. .I SLaTeX (Scandinavian LaTeX)
  385. tabular environment;
  386. .B tex
  387. to give a
  388. .I TeX
  389. simple tabbed alignment with ampersands as delimiters; and
  390. .B frame
  391. to give a tblstyle output for FrameMaker.
  392. .PP
  393. Other
  394. .I Set
  395. options are normally used only in 
  396. .I sc
  397. data files since they are available through 
  398. .IR ^T .
  399. You can also use them interactively
  400. .TP
  401. .BR autocalc / !autocalc
  402. Set/clear auto recalculation mode.
  403. .TP
  404. .BR numeric / !numeric
  405. Set/clear numeric mode.
  406. .TP
  407. .BR prescale / !prescale
  408. Set/clear numeric prescale mode.
  409. .TP
  410. .BR extfun / !extfun
  411. Enable/disable external functions.
  412. .TP
  413. .BR cellcur / !cellcur
  414. Set/clear current cell highlighting mode.
  415. .TP
  416. .BR toprow /  !toprow
  417. Set/clear top row display mode.
  418. .TP
  419. .BR rndinfinity /  !rndinfinity
  420. default: round-to-even (banker's round), *.5 will round to the closest even
  421. number; doing a 'set rndinfinity' will round *.5 up to the next integer
  422. (rounding to infinity).
  423. .TP
  424. .BI craction =n
  425. Set the newline action.
  426. .I n
  427. can be:
  428. .B 0
  429. (default) to give no action;
  430. .B 1
  431. to move down after each entry; or
  432. .B 2
  433. to move right after each entry.
  434. .TP
  435. .BI rowlimit =n
  436. Set the remembered limit for the maximum row below which
  437. the current cell will be moved to the top of the next column
  438. if the newline action is set to move the current cell down.
  439. .I n
  440. can be
  441. .B -1
  442. (default) to disable this facility.
  443. .TP
  444. .BI collimit =n
  445. Set the remembered limit for the maximum column to the right of which
  446. the current cell will be moved to the left of the next row
  447. if the newline action is set to move the current cell right.
  448. .I n
  449. can be
  450. .B -1
  451. (default) to disable this facility.
  452. .RE
  453. .\" ==========
  454. .SS "Cursor Control Commands"
  455. .\" ----------
  456. \0 \" exactly one blank line (hard to get)
  457. .PD 0
  458. .TP
  459. .B ^P
  460. Move the cell cursor up to the previous row.
  461. .PD
  462. .\" ----------
  463. .TP
  464. .B ^N
  465. Move the cell cursor down to the next row.
  466. .\" ----------
  467. .TP
  468. .B ^B
  469. Move the cell cursor backward one column.
  470. .\" ----------
  471. .TP
  472. .B ^F
  473. Move the cell cursor forward one column.
  474. .\" ----------
  475. .TP
  476. .B "h, j, k, l"
  477. If the character cursor is not on the top line, these are alternate,
  478. .IR vi -compatible
  479. cell cursor controls (left, down, up, right).
  480. Space is just like l (right).
  481. .TP
  482. .B "H, J, K, L"
  483. If the character cursor is not on the top line, these move the cursor
  484. by half pages (left, down, up, right).
  485. .\" ----------
  486. .TP
  487. .B ^H
  488. If the character cursor is not on the top line,
  489. .I ^H
  490. is the same as
  491. .IR ^B .
  492. .\" ----------
  493. .TP
  494. .B SPACE
  495. If the character cursor is not on the top line,
  496. the space bar is the same as
  497. .IR ^F .
  498. .\" ----------
  499. .TP
  500. .B TAB
  501. If the character cursor is on the top line,
  502. .SM TAB
  503. starts a range (see below).
  504. Otherwise, it is the same as
  505. .IR ^F .
  506. .\" ----------
  507. .TP
  508. .B "Arrow Keys"
  509. The terminal's arrow keys provide another alternate set of cell cursor controls
  510. if they exist and are supported in the appropriate
  511. .I termcap
  512. entry.
  513. Some terminals have arrow keys which conflict with other control key codes.
  514. For example, a terminal might send
  515. .I ^H
  516. when the back arrow key is pressed.
  517. In these cases, the conflicting arrow key performs the same function
  518. as the key combination it mimics.
  519. .\" ----------
  520. .TP
  521. .B ^
  522. Move the cell cursor up to row 0 of the current column.
  523. .\" ----------
  524. .TP
  525. .B #
  526. Move the cell cursor down to the last valid row of the current column.
  527. .\" ----------
  528. .TP
  529. .B 0
  530. Move the cell cursor backward to column A of the current row.
  531. This command must be prefixed with
  532. .I ^U
  533. if quick numeric entry mode is enabled.
  534. .\" ----------
  535. .TP
  536. .B $
  537. Move the cell cursor forward to the last valid column of the current row.
  538. .\" ----------
  539. .TP
  540. .B b
  541. Scan the cursor backward (left and up) to the previous valid cell.
  542. .\" ----------
  543. .TP
  544. .B w
  545. Scan the cursor forward (right and down) to the next valid cell.
  546. .\" ----------
  547. .TP
  548. .BI ^E d
  549. Go to end of range.
  550. Follow
  551. .I ^E
  552. by a direction indicator such as
  553. .I ^P
  554. or
  555. .IR j .
  556. If the cell cursor starts on a non-blank cell,
  557. it goes in the indicated direction until the last non-blank adjacent cell.
  558. If the cell cursor starts on a blank cell,
  559. it goes in the indicated direction until the first non-blank cell.
  560. This command is useful when specifying ranges of adjacent cells (see below),
  561. especially when the range is bigger than the visible window.
  562. .\" ----------
  563. .TP
  564. .B g
  565. Go to a cell.
  566. .I sc
  567. prompts for a cell's name, a regular expression surrounded by
  568. quotes, or a number.
  569. If a cell's name such as
  570. .I ae122 
  571. or a the name of a defined range is given, the cell cursor goes
  572. directly to that cell.
  573. If a quoted regular expression such as "
  574. .I Tax Table 
  575. " or "
  576. .I ^Jan [0-9]*$
  577. " is given,
  578. .I sc
  579. searches for a cell containing a string matching the regular
  580. expression.
  581. See 
  582. .I regex(3)
  583. or
  584. .I ed(1)
  585. for more details on the form of regular
  586. expressions.
  587. If a number is given, 
  588. .I sc
  589. will search for a cell containing that number.
  590. Searches for either strings or numbers proceed forward from the
  591. current cell, wrapping back to a0 at the end of the table, and
  592. terminate at the current cell if the string or number is not found.
  593. You may also go to a cell with an ERROR (divide by zero, etc in this cell)
  594. or INVALID (references a cell containing an ERROR).
  595. .IR g\ error
  596. will take you to the next ERROR, while
  597. .IR g\ invalid
  598. take you to the next invalid.
  599. The last
  600. .I g
  601. command is saved, and can be re-issued by entering 
  602. .IR g<return> .
  603. .\" ==========
  604. .SS "Cell Entry and Editing Commands"
  605. .\" ----------
  606. Cells can contain both a numeric value and a string value.
  607. Either value can be the result of an expression,
  608. but not both at once,
  609. i.e. each cell can have only one expression associated with it.
  610. Entering a valid numeric expression
  611. alters the cell's previous numeric value, if any,
  612. and replaces the cell's previous string expression, if any,
  613. leaving only the previously computed constant label string.
  614. Likewise, entering a valid string expression
  615. alters the cell's the previous label string, if any,
  616. and replaces the cell's previous numeric expression, if any,
  617. leaving only the previously computed constant numeric value.
  618. .TP
  619. .B =
  620. Enter a numeric constant or expression into the current cell.
  621. .I sc
  622. prompts for the expression on the top line.
  623. The usual way to enter a number into a cell is to type ``='',
  624. then enter the number in response to the prompt on the top line.
  625. The quick numeric entry option, enabled through the
  626. .B \-n
  627. option or
  628. .I ^T
  629. command, shows the prompt when you enter the first digit of a number
  630. (you can skip typing ``='').
  631. .\" ----------
  632. .TP
  633. .B <
  634. Enter a label string into the current cell
  635. to be flushed left against the left edge of the cell.
  636. .\" ----------
  637. .IP \fB"\fP
  638. Enter a label string into the current cell
  639. to be centered in the column.
  640. .\" ----------
  641. .TP
  642. .B >
  643. Enter a label string into the current cell
  644. to be flushed right against the right edge of the cell.
  645. .\" ----------
  646. .TP
  647. .B F
  648. Enter a format string into the current cell.  This format string
  649. overrides the precision specified with the ``f'' command.
  650. The format only applies to numeric values.  The following 
  651. characters can be used to build a format string:
  652. .RS
  653. .TP
  654. .BR #
  655. Digit placeholder.  If the number has fewer digits on either
  656. side of the decimal point than  there are `#' characters in
  657. the format, the extra `#' characters are ignored.  The number
  658. is rounded to the number of digit placeholders as there are
  659. to the right of the decimal point.  If there are more digits
  660. in the number than there are digit placeholders on the left
  661. side of the decimal point, then those digits are displayed.
  662. .TP
  663. .BR 0
  664. Digit placeholder.
  665. Same as for `#' except that the number
  666. is padded with zeroes on either side of the decimal point.
  667. The number of zeroes used in padding is determined by the
  668. number of digit placeholders after the `0' for digits on
  669. the left side of the decimal point and by the number of
  670. digit placeholders before the `0' for digits on the right
  671. side of the decimal point.
  672. .TP
  673. .BR .
  674. Decimal point.
  675. Determines how many digits are placed on
  676. the right and left sides of the decimal point in the number.
  677. Note that numbers smaller than 1 will begin with a decimal
  678. point if the left side of the decimal point contains only
  679. a `#' digit placeholder.  Use a `0' placeholder to get a
  680. leading zero in decimal formats.
  681. .TP
  682. .BR %
  683. Percentage.
  684. For each `%' character in the format, the actual
  685. number gets multiplied by 100 (only for purposes of formatting
  686. -- the original number is left unmodified) and the `%' character
  687. is placed in the same position as it is in the format.
  688. .TP
  689. .BR ,
  690. Thousands separator.
  691. The presence of a `,' in the format
  692. (multiple commas are treated as one) will cause the number
  693. to be formatted with a `,' separating each set of three digits
  694. in the integer part of the number with numbering beginning
  695. from the right end of the integer.
  696. .TP
  697. .BR \e
  698. Quote.
  699. This character causes the next character to be
  700. inserted into the formatted string directly with no
  701. special interpretation.
  702. .TP
  703. .BR E-\ E+\ e-\ e+
  704. Scientific format.
  705. Causes the number to formatted in scientific
  706. notation.  The case of the `E' or `e' given is preserved.  If
  707. the format uses a `+', then the sign is always given for the
  708. exponent value.  If the format uses a `-', then the sign is
  709. only given when the exponent value is negative.  Note that if
  710. there is no digit placeholder following the `+' or `-', then
  711. that part of the formatted number is left out.  In general,
  712. there should be one or more digit placeholders after the `+'
  713. or `-'.
  714. .TP
  715. .BR ;
  716. Format selector.
  717. Use this character to separate the format
  718. into two distinct formats.  The format to the left of the
  719. `;' character will be used if the number given is zero or
  720. positive.  The format to the right of the `;' character is
  721. used if the number given is negative.
  722. .RE
  723. .IP
  724. Some example formats are integer (``0'' or ``#''),
  725. fixed (``0.00''), percentage (``0%'' or ``0.00%''),
  726. scientific (``0.00E+00''),
  727. and currency (``$#,0.00;($#,0.00)'').
  728. .\" ----------
  729. .PP
  730. Strings you enter must start with ".
  731. You can leave off the trailing " and
  732. .I sc
  733. will add it for you.
  734. You can also enter a string expression
  735. by backspacing over the opening " in the prompt.
  736. .\" ----------
  737. .TP
  738. .B e
  739. Edit the value associated with the current cell.
  740. This is identical to ``=''
  741. except that the command line starts out containing
  742. the old numeric value or expression associated with the cell.
  743. The editing in this mode is vi-like.
  744. .RS
  745. .TP
  746. .BR ^h 
  747. Move back a character
  748. .TP
  749. .BR +
  750. Forward through history (neat) (same as j)
  751. .TP
  752. .BR - 
  753. Backward through history (neat) (same as k)
  754. .TP
  755. .BR ESC
  756. Done editing
  757. .TP
  758. .BR TAB
  759. Mark && append a range (ex: A0:A0)
  760. .br
  761. TAB, move around within a range; TAB, append range string.
  762. .TP
  763. .BR CR
  764. Save
  765. .TP
  766. .BR $
  767. Goto last column
  768. .TP
  769. .BR .
  770. Insert current dot buffer
  771. .TP
  772. .BR /
  773. Search for a string in the history
  774. .RS
  775. \fBESC\fP    edit the string you typed
  776. .br
  777. \fBCR\fP    search
  778. .br
  779. \fB^h\fP    backspace
  780. .RE
  781. .TP
  782. .BR 0
  783. Goto column 0
  784. .TP
  785. .BR D
  786. Delete to send
  787. .TP
  788. .BR I
  789. Insert at column 0; ESC revert back to edit mode
  790. .TP
  791. .BR R
  792. Replace mode; ESC revert back to edit mode
  793. .TP
  794. .BR X
  795. Delete the char to the left
  796. .TP
  797. .BR a
  798. Append after cursor; ESC revert back to edit mode
  799. .TP
  800. .BR b
  801. Move back a word
  802. .TP
  803. .BR c
  804. Change mode; ESC revert back to edit mode
  805. .TP
  806. .BR d
  807. Delete ...
  808. .RS
  809. \fBb\fP    back word\br
  810. .br
  811. \fBf\fP    forward (right)\br
  812. .br
  813. \fBh\fP    back char\br
  814. .br
  815. \fBl\fP    forward\br
  816. .br
  817. \fBt\fP    delete forward up to a given char (next char typed)\br
  818. .br
  819. \fBw\fP    delete next word forward\br
  820. .RE
  821. .TP
  822. .BR f
  823. Find the next char typed
  824. .TP
  825. .BR h
  826. Move left a char
  827. .TP
  828. .BR i
  829. Insert before cursor; ESC revert back to edit mode
  830. .TP
  831. .BR j
  832. Forward through history (neat) (same as +)
  833. .TP
  834. .BR k
  835. Backward through history (neat) (same as -)
  836. .TP
  837. .BR l
  838. Move right a char
  839. .TP
  840. .BR n
  841. Continue search
  842. .TP
  843. .BR q
  844. Stop editing
  845. .TP
  846. .BR r
  847. Replace char
  848. .TP
  849. .BR t
  850. Goto a char
  851. .TP
  852. .BR u
  853. Undo
  854. .TP
  855. .BR w
  856. Forward a word
  857. .TP
  858. .BR x
  859. Delete the current char (moving to the right)
  860. .RE
  861. .\" ----------
  862. .TP
  863. .B E
  864. Edit the string associated with the current cell.
  865. This is identical to ``<'', ``"'', or ``>''
  866. except that the command line starts out containing
  867. the old string value or expression associated with the cell.
  868. SEE
  869. .B e
  870. ABOVE.
  871. .\" ----------
  872. .PP
  873. To enter and edit a cell's number part, use the ``='' and
  874. .I e
  875. commands.
  876. To enter and edit a cell's string part, use the ``<'', ``"'', ``>'', and
  877. .I E
  878. commands.
  879. See the sections below on numeric and string expressions for more information.
  880. .\" ----------
  881. .TP
  882. .B x
  883. Clear the current cell.
  884. Deletes the numeric value, label string, and/or numeric or string expression.
  885. You can prefix this command with a count
  886. of the number of cells on the current row to clear.  The current column is
  887. used if column recalculation order is set.
  888. Cells cleared with this command may be recalled
  889. with any of the
  890. .I pull
  891. commands (see below).
  892. .\" ----------
  893. .TP
  894. .B m
  895. Mark a cell to be used as the source for the
  896. .I copy
  897. command.
  898. .\" ----------
  899. .TP
  900. .B c
  901. Copy the last marked cell to the current cell,
  902. updating row and column references in its numeric or string expression, if any.
  903. .\" ----------
  904. .TP
  905. .B +
  906. If not in numeric mode, add the current numeric argument (default 1)
  907. to the value of the current cell.  In numeric mode, ``+'' introduces a new
  908. numeric expression or value, the same as ``=''. 
  909. .\" ----------
  910. .TP
  911. .B -
  912. If not in numeric mode, subtract the current numeric argument (default 1)
  913. from the value of the current cell.  In numeric mode, ``-'' introduces a new,
  914. negative, numeric expression or value, like ``=''. 
  915. .\" ----------
  916. .TP
  917. .B RETURN
  918. If you are not editing a cell (top line is empty), pressing RETURN
  919. will make
  920. .I sc
  921. enter insert mode. At this point you may type any valid command or press
  922. .B ESC
  923. once to edit.
  924. .\" ==========
  925. .SS "File Commands"
  926. .\" ----------
  927. \0 \" exactly one blank line (hard to get)
  928. .PD 0
  929. .TP
  930. .B G
  931. Get a new database from a file.
  932. If encryption is enabled,
  933. the file is decrypted before it is loaded into the spreadsheet.
  934. .PD
  935. .\" ----------
  936. .TP
  937. .B P
  938. Put the current database into a file.
  939. If encryption is enabled,
  940. the file is encrypted before it is saved.
  941. .\" ----------
  942. .TP
  943. .B W
  944. Write a listing of the current database into a file
  945. in a form that matches its appearance on the screen.
  946. This differs from the
  947. .I Put
  948. command in that its files are intended to be reloaded with
  949. .IR Get ,
  950. while
  951. .I Write
  952. produces a file for people to look at.  Hidden rows or columns
  953. are not shown when the data is printed.
  954. .\" ----------
  955. .TP
  956. .B T
  957. Write a listing of the current database to a file,
  958. but include delimiters suitable for processing by the
  959. .IR tbl ,
  960. .IR LaTeX ,
  961. or
  962. .I TeX
  963. table processors.
  964. The delimiters are controlled by the
  965. .I tblstyle
  966. option.  See
  967. .I Set
  968. above.
  969. The delimiters are are a colon\ (:) for style
  970. .IR 0
  971. or
  972. .IR tbl
  973. and an ampersand\ (&) for style
  974. .IR latex
  975. or
  976. .IR tex .
  977. .\" ----------
  978. .PP
  979. With the
  980. .IR Put ,
  981. .IR Write ,
  982. and
  983. .I Table
  984. commands, the optional range argument writes a subset of the spreadsheet to
  985. the output file.
  986. .\" ----------
  987. .PP
  988. With the
  989. .I Write
  990. and
  991. .I Table
  992. commands, if you try to write to the last file used with the
  993. .I Get
  994. or
  995. .I Put
  996. commands, or the file specified on the command line when
  997. .I sc
  998. was invoked, you are asked to confirm
  999. that the (potentially) dangerous operation is really what you want.
  1000. .\" ----------
  1001. .PP
  1002. The three output commands,
  1003. .IR Put ,
  1004. .IR Write ,
  1005. and
  1006. .IR Table ,
  1007. can pipe their (unencrypted only) output to a program.
  1008. To use this feature,
  1009. enter ``| program'' to the prompt asking for a filename.
  1010. For example, to redirect the output of the
  1011. .I Write
  1012. command to the printer,
  1013. you might enter ``| lpr -p''.
  1014. .\" ----------
  1015. .TP
  1016. .B M
  1017. Merge the database from the named file into the current database.
  1018. Values and expressions defined in the named file
  1019. are read into the current spreadsheet
  1020. overwriting the existing entries at matching cell locations.
  1021. .\" ----------
  1022. .TP
  1023. .B R
  1024. Run macros.
  1025. Since
  1026. .I sc
  1027. files are saved as ASCII files,
  1028. it is possible to use them as primitive macro definition files.
  1029. The
  1030. .I Run
  1031. command makes this easier.
  1032. It's like the
  1033. .I Merge
  1034. command,
  1035. but prints a saved path name as the start of the filename to merge in.
  1036. The string to use is set with the
  1037. .I Define
  1038. command.
  1039. To write macros, you must be familiar with the file format written by the
  1040. .I Put
  1041. command.
  1042. This facility is still primitive and could be much improved.
  1043. .\" ----------
  1044. .TP
  1045. .B D
  1046. Define a path for the
  1047. .I Run
  1048. command to use.
  1049. .\" ----------
  1050. .PP
  1051. All file operations take a filename as the first argument
  1052. to the prompt on the top line.
  1053. The prompt supplies a " to aid in typing in the filename.
  1054. The filename can also be obtained from a cell's label string
  1055. or string expression.
  1056. In this case, delete the leading " with the backspace key
  1057. and enter a cell name such as
  1058. .I a22
  1059. instead.
  1060. If the resulting string starts with ``|'',
  1061. the rest of the string is interpreted as a
  1062. .SM UNIX
  1063. command, as above.
  1064. .\" ==========
  1065. .SS "Row and Column Commands"
  1066. .\" ----------
  1067. These commands can be used on either rows or columns.
  1068. The second letter of the command is either a row designator
  1069. (one of the characters
  1070. .IR r ,
  1071. .IR ^B ,
  1072. .IR ^F ,
  1073. .IR h ,
  1074. .IR l )
  1075. or a column designator (one of
  1076. .IR c ,
  1077. .IR ^P ,
  1078. .IR ^N ,
  1079. .IR k ,
  1080. .IR j ).
  1081. A small menu lists the choices for the second letter
  1082. when you type the first letter of one of these commands.
  1083. Commands which move or copy cells
  1084. also modify the row and column references in affected cell expressions.
  1085. The references may be frozen by using the
  1086. .I fixed
  1087. operator or using the
  1088. .I $
  1089. character in the reference to the cell (see below).
  1090. .\" ----------
  1091. .TP
  1092. .B "ir, ic"
  1093. Insert a new row (column)
  1094. by moving the row (column) containing the cell cursor,
  1095. and all following rows (columns), down (right) one row (column).
  1096. The new row (column) is empty.
  1097. .\" ----------
  1098. .TP
  1099. .B "ar, ac"
  1100. Append a new row (column) immediately following the current row (column).
  1101. It is initialized as a copy of the current one.
  1102. .\" ----------
  1103. .TP
  1104. .B "dr, dc"
  1105. Delete the current row (column).
  1106. .\" ----------
  1107. .TP
  1108. .B "pr, pc, pm"
  1109. Pull deleted rows (columns) back into the spreadsheet.
  1110. The last deleted set of cells is put back into the spreadsheet
  1111. at the current location.
  1112. .I pr
  1113. inserts enough rows to hold the data.
  1114. .I pc
  1115. inserts enough columns to hold the data.
  1116. .I pm
  1117. (merge) does not insert rows or columns;
  1118. it overwrites the cells beginning at the current cell cursor location.
  1119. .\" ----------
  1120. .TP
  1121. .B "vr, vc"
  1122. Remove expressions from the affected rows (columns),
  1123. leaving only the values which were in the cells
  1124. before the command was executed.
  1125. .\" ----------
  1126. .TP
  1127. .B "zr, zc"
  1128. Hide (``zap'') the current row (column).
  1129. This keeps a row (column) from being displayed but keeps it in the data base.
  1130. The status of the rows and columns is saved with the data base so hidden
  1131. rows and columns will be still
  1132. be hidden when you reload the spreadsheet.  Hidden rows or columns are not
  1133. printed by the
  1134. .I W
  1135. command.
  1136. .\" ----------
  1137. .TP
  1138. .B "sr, sc"
  1139. Show hidden rows (columns).
  1140. Enter a range of rows (columns) to be revealed.
  1141. The default is the first range of rows (columns) currently hidden.
  1142. This command ignores the repeat count, if any.
  1143. .\" ----------
  1144. .TP
  1145. .B f
  1146. Set the output format to be used
  1147. for printing the numeric values in each cell in the current column.
  1148. Enter three numbers:
  1149. the total width in characters of the column,
  1150. the number of digits to follow decimal points,
  1151. and the format type.  Format types are 0 for fixed point,
  1152. 1 for scientific notation, 2 for engineering notation, and 3 for dates.
  1153. Values are rounded off to the least significant digit displayed.
  1154. The total column width affects displays of strings as well as numbers.
  1155. A preceding count can be used to affect more than one column.
  1156. This command has only a column version (no second letter).
  1157. .\" ----------
  1158. .TP
  1159. .B "@myrow, @mycol"
  1160. Are functions that return the row or column of the current cell respectively.
  1161. ex: The cell directly above a cell in the D column could then be accessed
  1162. by @nval("d",@myrow-1).
  1163. NOTE: @myrow and @mycol can't be used in specifying ranges.
  1164. .\" ==========
  1165. .SS "Range Commands"
  1166. .\" ----------
  1167. Range operations affect a rectangular region on the screen
  1168. defined by the upper left and lower right cells in the region.
  1169. All of the commands in this class start with a slash;
  1170. the second letter of the command indicates which command.
  1171. A small menu lists the choices for the second letter when you type ``/''.
  1172. .I sc
  1173. prompts for needed parameters for each command.
  1174. Phrases surrounded by square brackets in the prompt are informational only
  1175. and may be erased with the backspace key.
  1176. .\" ----------
  1177. .PP
  1178. Prompts requesting variable names may be satisfied
  1179. with either an explicit variable name, such as
  1180. .IR A10 ,
  1181. or with a variable name previously defined in a
  1182. .I /d
  1183. command (see below).
  1184. Range name prompts require either an explicit range such as
  1185. .IR A10:B20 ,
  1186. or a range name previously defined with a
  1187. .I /d
  1188. command.
  1189. A default range shown in the second line
  1190. is used if you omit the range from the command or press the
  1191. .SM TAB
  1192. key (see below).
  1193. The default range can be changed by moving the cell cursor
  1194. via the control commands
  1195. .RI ( ^P ,
  1196. .IR ^N ,
  1197. .IR ^B ,
  1198. .IR ^F )
  1199. or the arrow keys.
  1200. The cells in the default range are highlighted
  1201. (using the terminal's standout mode, if available).
  1202. .\" ----------
  1203. .TP
  1204. .B /x
  1205. Clear a range.
  1206. Cells cleared with this command may be recalled with any of the
  1207. .I pull
  1208. commands.
  1209. .\" ----------
  1210. .TP
  1211. .B /v
  1212. Values only.
  1213. This command removes the expressions from a range of cells,
  1214. leaving just the values of the expressions.
  1215. .\" ----------
  1216. .TP
  1217. .B /c
  1218. Copy a source range to a destination range.
  1219. The source and destination may be different sizes.
  1220. The result is always one or more full copies of the source.
  1221. Copying a row to a row yields a row.
  1222. Copying a column to a column yields a column.
  1223. Copying a range to anything yields a range.
  1224. Copying a row to a column or a column to a row yields a range
  1225. with as many copies of the source as there are cells in the destination.
  1226. This command can be used to duplicate a cell through an arbitrary range
  1227. by making the source a single cell range such as
  1228. .IR b20:b20 .
  1229. .\" ----------
  1230. .TP
  1231. .B /f
  1232. Fill a range with constant values
  1233. starting with a given value and increasing by a given increment.
  1234. Each row is filled before moving on to the next row if row order
  1235. recalculation is set.  Column order fills each column in the range
  1236. before moving on to the next column.
  1237. The start and increment numbers may be positive or negative.
  1238. To fill all cells with the same value, give an increment of zero.
  1239. .\" ----------
  1240. .TP
  1241. .B /d
  1242. Use this command to assign a symbolic name to a single cell
  1243. or a rectangular range of cells on the screen.
  1244. The parameters are the name, surrounded by "",
  1245. and either a single cell name such as
  1246. .I A10
  1247. or a range such as
  1248. .IR a1:b20 .
  1249. Names defined in this fashion are used by the program in future prompts,
  1250. may be entered in response to prompts requesting a cell or range name,
  1251. and are saved when the spreadsheet is saved with the
  1252. .I Put
  1253. command.
  1254. Names defined must be more than two alpha characters long
  1255. to differentiate them from a column names,
  1256. and must not have embedded special characters.
  1257. Names may include the character ``_'' or numerals
  1258. as long as they occur after the first three alpha characters.
  1259. .\" ----------
  1260. .TP
  1261. .B /l
  1262. Use this command to lock the current cell or a range of cells, i.e
  1263. make them immune to any type of editing. A locked cell can't be changed
  1264. in anyway until it is unlocked.
  1265. .TP
  1266. .B /U
  1267. This command is the opposite of the
  1268. .I /l
  1269. command and thus unlocks a locked cell and makes it editable.
  1270. .TP
  1271. .B /s
  1272. This command lists (shows) the currently defined range names.
  1273. If there are no defined range names, then a message is given,
  1274. otherwise
  1275. it pipes output to
  1276. .IR sort ,
  1277. then to
  1278. .IR less .
  1279. If the environment variable PAGER is set, its value is used in place of
  1280. .IR less.
  1281. .\" ----------
  1282. .TP
  1283. .B /u
  1284. Use this command to undefine a previously defined range name.
  1285. .TP
  1286. .B /F
  1287. Use this command to assign a value format string (see the ``F''
  1288. cell entry command) to a range of cells.
  1289. .\" ==========
  1290. .SS "Miscellaneous Commands"
  1291. .\" ----------
  1292. \0 \" exactly one blank line (hard to get)
  1293. .PD 0
  1294. .TP
  1295. .B Q
  1296. .TP
  1297. .B q
  1298. .TP
  1299. .B ^C
  1300. Exit from
  1301. .IR sc .
  1302. If you made any changes since the last
  1303. .I Get
  1304. or
  1305. .IR Put ,
  1306. .I sc
  1307. asks about saving your data before exiting.
  1308. .PD
  1309. .\" ----------
  1310. .TP
  1311. .B ^G
  1312. .PD 0
  1313. .TP
  1314. .B ESC
  1315. Abort entry of the current command.
  1316. .PD
  1317. .\" ----------
  1318. .TP
  1319. .B ?
  1320. Enter an interactive help facility.  Lets you look up brief
  1321. summaries of the main features of the program.  The help facility is
  1322. structured like this manual page so it is easy to find more
  1323. information on a particular topic.
  1324. .\" ----------
  1325. .TP
  1326. .B !
  1327. Shell escape.
  1328. .I sc
  1329. prompts for a shell command to run.
  1330. End the command line with the
  1331. .SM RETURN
  1332. key.
  1333. If the environment variable
  1334. .SM SHELL
  1335. is defined, that shell is run.
  1336. If not, /bin/sh is used.
  1337. Giving a null command line starts the shell in interactive mode.
  1338. A second ``!'' repeats the previous command.
  1339. .\" ----------
  1340. .TP
  1341. .B ^L
  1342. Redraw the screen.
  1343. .\" ----------
  1344. .TP
  1345. .B ^R
  1346. Redraw the screen with special highlighting of cells to be filled in.
  1347. This is useful for finding values you need to provide or update
  1348. in a form with which you aren't familiar
  1349. or of which you have forgotten the details.
  1350.  
  1351. It's also useful for checking a form you are creating.
  1352. All cells which contain constant numeric values
  1353. (not the result of a numeric expression)
  1354. are highlighted temporarily,
  1355. until the next screen change, however minor.
  1356. To avoid ambiguity,
  1357. the current range (if any) and current cell are not highlighted.
  1358. .\" ----------
  1359. .TP
  1360. .B ^X
  1361. This command is similar to
  1362. .IR ^R ,
  1363. but highlights cells which have expressions.
  1364. It also displays the expressions in the highlighted cells
  1365. as left-flushed strings,
  1366. instead of the numeric values and/or label strings of those cells.
  1367. This command makes it easier to check expressions,
  1368. at least when they fit in their cells or the following cell(s) are blank
  1369. so the expressions can slop over (like label strings).
  1370. In the latter case, the slop over is not cleared on the next screen update,
  1371. so you may want to type
  1372. .I ^L
  1373. after the
  1374. .I ^X
  1375. in order to clean up the screen.
  1376. .\" ----------
  1377. .TP
  1378. .B @
  1379. Recalculates the spreadsheet.
  1380. .\" ----------
  1381. .TP
  1382. .B ^V
  1383. Type, in the command line, the name of the current cell
  1384. (the one at the cell cursor).
  1385. This is useful when entering expressions
  1386. which refer to other cells in the table.
  1387. .\" ----------
  1388. .TP
  1389. .B ^W
  1390. Type, in the command line, the expression attached to the current cell.
  1391. If there is none, the result is ``?''.
  1392. .\" ----------
  1393. .TP
  1394. .B ^A
  1395. Type, in the command line, the numeric value of the current cell, if any.
  1396. .\" ----------
  1397. .PP
  1398. The
  1399. .IR ^V ,
  1400. .IR ^W ,
  1401. and
  1402. .I ^A
  1403. commands only work when the character cursor
  1404. is on the command line and beyond the first character.
  1405. .\" ----------
  1406. .TP
  1407. .B TAB
  1408. When the character cursor is on the top line,
  1409. defines a range of cells via the cursor control commands or the arrow keys.
  1410. The range is highlighted,
  1411. starts at the cell where you typed
  1412. .SM TAB,
  1413. and continues through the current cell cursor.
  1414. Pressing
  1415. .SM TAB
  1416. again causes the highlighted range to be entered into the command line
  1417. and the highlighting to be turned off.
  1418. This is most useful for defining ranges to functions such as
  1419. .IR @sum ().
  1420. Pressing ``)'' acts just like typing the
  1421. .SM TAB
  1422. key the second time and adds the closing ``)''.
  1423. Note that when you give a range command,
  1424. you don't need to press the first
  1425. .SM TAB
  1426. to begin defining a range starting with the current cell.
  1427. .\" ==========
  1428. .SS "Variable Names"
  1429. .\" ----------
  1430. Normally, a variable name is just the name of a cell, such as
  1431. .IR K20 .
  1432. The value is the numeric or string value of the cell,
  1433. according to context.
  1434. .\" ----------
  1435. .PP
  1436. When a cell's expression (formula) is copied to another location via
  1437. .I copy
  1438. or
  1439. .IR range-copy ,
  1440. variable references are by default offset by the amount the formula moved.
  1441. This allows the new formula to work on new data.
  1442. If cell references are not to change,
  1443. you can either use the
  1444. .I fixed
  1445. operator (see below),
  1446. or one of the following variations on the cell name.
  1447. .\" ----------
  1448. .TP
  1449. .I K20
  1450. References cell
  1451. .IR K20 ;
  1452. the reference changes when the formula is copied.
  1453. .\" ----------
  1454. .TP
  1455. .BI $ K $ 20
  1456. Always refers to cell
  1457. .IR K20 ;
  1458. the reference stays fixed when the formula is copied.
  1459. .\" ----------
  1460. .TP
  1461. .BI $ K20
  1462. Keeps the column fixed at column K;
  1463. the row is free to vary.
  1464. .\" ----------
  1465. .TP
  1466. .IB K $ 20
  1467. Similarly, this fixes the row and allows the column to vary.
  1468. .\" ----------
  1469. .PP
  1470. These conventions also hold on defined ranges.
  1471. Range references vary when formulas containing them are copied.
  1472. If the range is defined with fixed variable references,
  1473. the references do not change.
  1474. .\" ----------
  1475. .TP
  1476. .B fixed
  1477. To make a variable not change automatically when a cell moves,
  1478. put the word
  1479. .I fixed
  1480. in front of the reference, for example:
  1481. B1 \(** fixed C3.
  1482. .\" ==========
  1483. .SS "Numeric Expressions"
  1484. .\" ----------
  1485. Numeric expressions used with the ``=''
  1486. and
  1487. .I e
  1488. commands have a fairly conventional syntax.
  1489. Terms may be
  1490. constants,
  1491. variable names,
  1492. parenthesized expressions,
  1493. and negated terms.
  1494. Ranges may be operated upon with range functions such as sum
  1495. .RI ( @sum ())
  1496. and average
  1497. .RI ( @avg ()).
  1498. Terms may be combined using binary operators.
  1499. .\" ----------
  1500. .TP
  1501. .BR \- e
  1502. Negation.
  1503. .\" ----------
  1504. .TP
  1505. .RB e + e
  1506. Addition.
  1507. .\" ----------
  1508. .TP
  1509. .RB e \- e
  1510. Subtraction.
  1511. .\" ----------
  1512. .TP
  1513. .RB e \(** e
  1514. Multiplication.
  1515. .\" ----------
  1516. .TP
  1517. .RB e / e
  1518. Division.
  1519. .\" ----------
  1520. .TP
  1521. .RB e1 % e2
  1522. e1 mod e2.
  1523. .\" ----------
  1524. .TP
  1525. .RB e ^ e
  1526. Exponentiation.
  1527. .\" ----------
  1528. .TP
  1529. .RB e < e
  1530. .PD 0
  1531. .TP
  1532. .RB e <= e
  1533. .TP
  1534. .RB e = e
  1535. .TP
  1536. .RB e != e
  1537. .TP
  1538. .RB e >= e
  1539. .TP
  1540. .RB e > e
  1541. Relationals:
  1542. true (1) if and only if the indicated relation holds,
  1543. else false (0).
  1544. Note that ``<='', ``!='', and ``>=''
  1545. are converted to their ``~()'' equivalents.
  1546. .PD
  1547. .\" ----------
  1548. .TP
  1549. .BR ~ e
  1550. Boolean operator
  1551. .SM NOT.
  1552. .\" ----------
  1553. .TP
  1554. .RB e & e
  1555. Boolean operator
  1556. .SM AND.
  1557. .\" ----------
  1558. .TP
  1559. .RB e | e
  1560. Boolean operator
  1561. .SM OR.
  1562. .\" ----------
  1563. .TP
  1564. .RB @if (e, e, e)
  1565. .PD 0
  1566. .TP
  1567. .RB e ? e : e
  1568. Conditional:
  1569. If the first expression is true then the value of the second is returned,
  1570. otherwise the value of the third.
  1571. .\" ----------
  1572. .PP
  1573. Operator precedence from highest to lowest is:
  1574. .PP
  1575. .nf
  1576. .RS
  1577. \-, ~
  1578. ^
  1579. \(**, /
  1580. +, \-
  1581. <, <=, =, !=, >=, >
  1582. &
  1583. |
  1584. ?:
  1585. .RE
  1586. .fi
  1587. .\" ==========
  1588. .SS "Built-in Range Functions"
  1589. .\" ----------
  1590. These functions return numeric values.
  1591. .\" ----------
  1592. .TP 18
  1593. .BR @sum (r)
  1594. Sum all valid (nonblank) entries in the region
  1595. whose two corners are defined by the two variable names (e.g.
  1596. .IR c5:e14 )
  1597. or the range name specified.
  1598. .\" ----------
  1599. .TP 18
  1600. .BR @prod (r)
  1601. Multiply together all valid (nonblank) entries in the specified region.
  1602. .\" ----------
  1603. .TP 18
  1604. .BR @avg (r)
  1605. Average all valid (nonblank) entries in the specified region.
  1606. .\" ----------
  1607. .TP 18
  1608. .BR @count (r)
  1609. Count all valid (nonblank) entries in the specified region.
  1610. .\" ----------
  1611. .TP 18
  1612. .BR @max (r)
  1613. Return the maximum value in the specified region.  See also the multi argument
  1614. version of
  1615. .I @max
  1616. below.
  1617. .\" ----------
  1618. .TP 18
  1619. .BR @min (r)
  1620. Return the minimum value in the specified region.  See also the multi argument
  1621. version of
  1622. .I @min
  1623. below.
  1624. .\" ----------
  1625. .TP 18
  1626. .BR @stddev (r)
  1627. Return the sample standard deviation of the cells in the specified region.
  1628. .\" ----------
  1629. .TP 18
  1630. .BR @lookup (e,r)
  1631. .PD 0
  1632. .TP 18
  1633. .BR @lookup (se,r)
  1634. .PD
  1635. Evaluates the expression then searches through the range
  1636. .I r
  1637. for a matching value.
  1638. The range should be either a single row or a single column.
  1639. The expression can be either a string
  1640. expression or a numeric expression.  If it is a numeric expression,
  1641. the range is searched for the the last value less than or equal to 
  1642. .IR e .
  1643. If the expression is a string expression, the string portions
  1644. of the cells in the range are searched for an exact string match.
  1645. The value returned is the numeric value from the next row and the same
  1646. column as the match, if the range was a single row, or the value from
  1647. the next column and the same row as the match if the range was a single
  1648. column.
  1649. .\" ----------
  1650. .TP 18
  1651. .BR @hlookup (e,r,n)
  1652. .PD 0
  1653. .TP 18
  1654. .BR @hlookup (se,r,n)
  1655. .PD
  1656. Evaluates the expression then searches through the first row in the range
  1657. .I r
  1658. for a matching value.
  1659. The expression can be either a string
  1660. expression or a numeric expression.  If it is a numeric expression,
  1661. the row is searched for the the last value less than or equal to 
  1662. .IR e .
  1663. If the expression is a string expression, the string portions
  1664. of the cells in the row are searched for an exact string match.
  1665. The value returned is the numeric value from the same column
  1666. .I n
  1667. rows below the match.
  1668. .\" ----------
  1669. .TP 18
  1670. .BR @vlookup (e,r,n)
  1671. .PD 0
  1672. .TP 18
  1673. .BR @vlookup (se,r,n)
  1674. .PD
  1675. Evaluates the expression then searches through the first column in the range
  1676. .I r
  1677. for a matching value.
  1678. The expression can be either a string
  1679. expression or a numeric expression.  If it is a numeric expression,
  1680. the column is searched for the the last value less than or equal to 
  1681. .IR e .
  1682. If the expression is a string expression, the string portions
  1683. of the cells in the column are searched for an exact string match.
  1684. The value returned is the numeric value from the same row
  1685. .I n
  1686. columns to the right of the match.
  1687. .\" ----------
  1688. .TP 18
  1689. .BR @index (e,r)
  1690. Use the value of the expression 
  1691. .I e
  1692. to index into
  1693. the range
  1694. .IR r .
  1695. The numeric value at that position is returned. 
  1696. The value 1 selects the first item in the range,
  1697. 2 selects the second item, etc.
  1698. .I R
  1699. should be either a single row or a single
  1700. column.
  1701. .\" ----------
  1702. .TP 18
  1703. .BR @stindex (e,r)
  1704. Use the value of 
  1705. .I e
  1706. to index into
  1707. the range
  1708. .IR r .
  1709. The string value at that position is returned. 
  1710. The value 1 selects the first item in the range,
  1711. 2 selects the second item, etc.
  1712. The range should be either a single row or a single
  1713. column.
  1714. .\" ==========
  1715. .SS "Built-in Numeric Functions"
  1716. .\" ----------
  1717. All of these functions operate on floating point numbers (doubles)
  1718. and return numeric values.
  1719. Most of them are standard system functions more fully described in
  1720. .IR math (3).
  1721. The trig functions operate with angles in radians.
  1722. .\" ----------
  1723. .TP 18
  1724. .BR @sqrt (e)
  1725. Return the square root of
  1726. .IR e .
  1727. .\" ----------
  1728. .TP 18
  1729. .BR @exp (e)
  1730. Return the exponential function of
  1731. .IR e .
  1732. .\" ----------
  1733. .TP 18
  1734. .BR @ln (e)
  1735. Return the natural logarithm of
  1736. .IR e .
  1737. .\" ----------
  1738. .TP 18
  1739. .BR @log (e)
  1740. Return the base 10 logarithm of
  1741. .IR e .
  1742. .\" ----------
  1743. .TP 18
  1744. .BR @floor (e)
  1745. Return the largest integer not greater than
  1746. .IR e .
  1747. .\" ----------
  1748. .TP 18
  1749. .BR @ceil (e)
  1750. Return the smallest integer not less than
  1751. .IR e .
  1752. .\" ----------
  1753. .TP 18
  1754. .BR @rnd (e)
  1755. Round
  1756. .I e
  1757. to the nearest integer.
  1758. default: round-to-even (banker's round), *.5 will round to the closest even
  1759. number; 'set rndinfinity' will round *.5 up to the next integer.
  1760. .TP 18
  1761. .BR @round (e,n)
  1762. Round
  1763. .I e
  1764. to
  1765. .I n
  1766. decimal places.
  1767. n may be positive to round off the right side of the decimal,
  1768. and negative to round off the left side. See @rnd(e) above for rounding
  1769. types.
  1770. .\" ----------
  1771. .TP 18
  1772. .BR @abs (e)
  1773. .PD 0
  1774. .TP 18
  1775. .BR @fabs (e)
  1776. Return the absolute value of
  1777. .IR e .
  1778. .\" ----------
  1779. .TP 18
  1780. .BR @pow (e1,e2)
  1781. Return
  1782. .I e1
  1783. raised to the power of
  1784. .IR e2 .
  1785. .\" ----------
  1786. .TP 18
  1787. .BR @hypot (e1,e2)
  1788. Return sqrt(e1\(**e1+e2\(**e2), taking precautions against unwarranted
  1789. overflows.
  1790. .\" ----------
  1791. .TP 18
  1792. .B pi\ \ @pi
  1793. A constant quite close to pi.
  1794. .\" ----------
  1795. .TP 18
  1796. .BR @dtr (e)
  1797. Convert
  1798. .I e
  1799. in degrees to radians.
  1800. .\" ----------
  1801. .TP 18
  1802. .BR @rtd (e)
  1803. Convert
  1804. .I e
  1805. in radians to degrees.
  1806. .\" ----------
  1807. .TP 18
  1808. .BR @sin (e)
  1809. .PD 0
  1810. .TP 18
  1811. .BR @cos (e)
  1812. .TP 18
  1813. .BR @tan (e)
  1814. Return trigonometric functions of radian arguments.
  1815. The magnitude of the arguments are not checked to assure meaningful results.
  1816. .PD
  1817. .\" ----------
  1818. .TP 18
  1819. .BR @asin (e)
  1820. Return the arc sine of
  1821. .I e
  1822. in the range -pi/2 to pi/2.
  1823. .\" ----------
  1824. .TP 18
  1825. .BR @acos (e)
  1826. Return the arc cosine of
  1827. .I e
  1828. in the range 0 to pi.
  1829. .\" ----------
  1830. .TP 18
  1831. .BR @atan (e)
  1832. Return the arc tangent of
  1833. .I e
  1834. in the range -pi/2 to pi/2.
  1835. .\" ----------
  1836. .TP 18
  1837. .BR @atan2 (e1,e2)
  1838. Returns the arc tangent of
  1839. .IR e1 / e2
  1840. in the range -pi to pi.
  1841. .\" ----------
  1842. .TP 18
  1843. .BR @max (e1,e2,...)
  1844. Return the maximum of the values of the expressions.  Two or more expressions
  1845. may be specified.  See also the range version of 
  1846. .I @max
  1847. above.
  1848. .\" ----------
  1849. .TP 18
  1850. .BR @min (e1,e2,...)
  1851. Return the minimum of the values of the expressions.  Two or more expressions
  1852. may be specified.  See also the range version of 
  1853. .I @min
  1854. above.
  1855. .\" ----------
  1856. .TP 18
  1857. .BR @ston (se)
  1858. Convert string expression
  1859. .I se
  1860. to a numeric value.
  1861. .\" ----------
  1862. .TP 18
  1863. .BR @eqs (se1,se2)
  1864. Return 1 if string expression
  1865. .I se1
  1866. has the same value as string expression
  1867. .IR se2 ,
  1868. 0 otherwise.
  1869. .\" ----------
  1870. .TP 18
  1871. .BR @nval (se,e)
  1872. Return the numeric value of a cell selected by name.
  1873. String expression
  1874. .I se
  1875. must evaluate to a column name (``A''-``AE'') and
  1876. .I e
  1877. must evaluate to a row number (0-199). 
  1878. If
  1879. .I se
  1880. or
  1881. .I e
  1882. is out of bounds, or the cell has no numeric value, the result is 0.
  1883. You can use this for simple table lookups.
  1884. Be sure the table doesn't move unexpectedly!
  1885. See also
  1886. .IR @sval ()
  1887. below.
  1888. .\" ==========
  1889. .SS "String Expressions"
  1890. .\" ----------
  1891. String expressions are made up of constant strings
  1892. (characters surrounded by double quotation marks),
  1893. variables
  1894. (cell names, which refer to the cells's label strings or expressions),
  1895. and string functions.
  1896. Note that string expressions are only allowed
  1897. when entering a cell's label string, not its numeric part.
  1898. Also note that string expression results may be left or right flushed or centered,
  1899. according to the type of the cell's string label.
  1900. .\" ----------
  1901. .TP
  1902. .B #
  1903. Concatenate strings.
  1904. For example, the string expression
  1905. .IP ""
  1906.     A0 # "zy dog"
  1907. .IP ""
  1908. displays the string ``the lazy dog'' in the cell if the value of
  1909. .IR A0 's
  1910. string is ``the la''.
  1911. .\" ==========
  1912. .SS "Built-in String Functions"
  1913. .\" ----------
  1914. \0 \" exactly one blank line (hard to get)
  1915. .PD 0
  1916. .TP 18
  1917. .BR @substr (se,e1,e2)
  1918. Extract and return from string expression
  1919. .I se
  1920. the substring indexed by character number
  1921. .I e1
  1922. through character number
  1923. .I e2
  1924. (defaults to the size of
  1925. .I se
  1926. if beyond the end of it).
  1927. If
  1928. .I e1
  1929. is less than 1 or greater than
  1930. .IR e2 ,
  1931. the result is the null string.
  1932. For example,
  1933. .PD
  1934. .IP ""
  1935.     @substr ("Nice jacket", 4, 7)
  1936. .IP ""
  1937. returns the string ``e jac''.
  1938. .\" ----------
  1939. .TP 18
  1940. .BR @fmt (se,e)
  1941. Convert a number to a string.
  1942. The argument
  1943. .I se
  1944. must be a valid
  1945. .IR printf (3)
  1946. format string.
  1947. .I e
  1948. is converted according to the standard rules.
  1949. For example, the expression
  1950. .IP ""
  1951.     @fmt ("\(**\(**%6.3f\(**\(**", 10.5)
  1952. .IP ""
  1953. yields the string ``\(**\(**10.500\(**\(**''.
  1954. .I e
  1955. is a double, so applicable formats are e, E, f, g, and G.
  1956. Try ``%g'' as a starting point.
  1957. .\" ----------
  1958. .TP 18
  1959. .BR @sval (se,e)
  1960. Return the string value of a cell selected by name.
  1961. String expression
  1962. .I se
  1963. must evaluate to a column name (``A''-``AE'') and
  1964. .I e
  1965. must evaluate to a row number (0-199). 
  1966. If
  1967. .I se
  1968. or
  1969. .I e
  1970. is out of bounds, or the cell has no string value,
  1971. the result is the null string.
  1972. You can use this for simple table lookups.
  1973. Be sure the table doesn't move unexpectedly!
  1974. .\" ----------
  1975. .TP 18
  1976. .BR @upper (e)
  1977. and
  1978. .BR @lower (e)
  1979. will case the string expression to upper or lower.
  1980. .\" ----------
  1981. .TP 18
  1982. .BR @capital (e)
  1983. will convert the first letter of words in a string
  1984. into upper case and other letters to lower case
  1985. (the latter if all letters of the string are upper case).
  1986. .\" ----------
  1987. .TP 18
  1988. .BR @upper (e)
  1989. and
  1990. .BR @lower (e)
  1991. will case the string expression to upper or lower.
  1992. .\" ----------
  1993. .TP 18
  1994. .BR @capital (e)
  1995. will convert the first letter of words in a string
  1996. into upper case.
  1997. .\" ----------
  1998. .TP 18
  1999. .BR @ext (se,e)
  2000. Call an external function (program or script).
  2001. The purpose is to allow arbitrary functions on values,
  2002. e.g. table lookups and interpolations.
  2003. String expression
  2004. .I se
  2005. is a command or command line to call with
  2006. .IR popen (3).
  2007. The value of
  2008. .I e
  2009. is converted to a string and appended to the command line as an argument.
  2010. The result of
  2011. .IR @ext ()
  2012. is a string:
  2013. the first line printed to standard output by the command.
  2014. The command should emit exactly one output line.
  2015. Additional output, or output to standard error, messes up the screen.
  2016. .IR @ext ()
  2017. returns a null string and prints an appropriate warning
  2018. if external functions are disabled,
  2019. .I se
  2020. is null, or the attempt to run the command fails.
  2021. .IP ""
  2022. External functions can be slow to run,
  2023. and if enabled are called at each screen update,
  2024. so they are disabled by default.
  2025. You can enable them with
  2026. .I ^T
  2027. when you really want them called.
  2028. .IP ""
  2029. A simple example:
  2030. .IP ""
  2031.     @ext ("echo", a1)
  2032. .IP ""
  2033. You can use
  2034. .IR @ston ()
  2035. to convert the
  2036. .IR @ext ()
  2037. result back to a number.
  2038. For example:
  2039. .IP ""
  2040.     @ston (@ext ("form.sc.ext", a9 + b9))
  2041. .IP ""
  2042. Note that you can built a command line (including more argument values)
  2043. from a string expression with concatenation.
  2044. You can also "hide" the second argument by ending the command line
  2045. (first argument) with `` #'' (shell comment).
  2046. .\" ----------
  2047. .TP 18
  2048. .BR @coltoa (e)
  2049. Returns a string name for a column from the numeric argument.
  2050. For example:
  2051. .IP ""
  2052.     @coltoa(@mycol-1)
  2053.     @nval(coltoa(@mycol-1), @myrow+1)
  2054. .IP ""
  2055. .\" ==========
  2056. .SS "Built-in Financial Functions"
  2057. .\" ----------
  2058. Financial functions compute the mortgage (or loan) payment, future value,
  2059. and the present value functions.  Each accepts
  2060. three arguments, an amount, a rate of interest (per period), and 
  2061. the number of periods.
  2062. These functions are the same as those commonly found in other spreadsheets
  2063. and financial calculators
  2064. .\" ----------
  2065. .TP 18
  2066. .BR @pmt (e1,e2,e3)
  2067. .IR @pmt (60000,.01,360)
  2068. computes the monthly payments for a $60000 mortgage at 12% annual interest
  2069. (.01 per month) for 30 years (360 months).
  2070. .\" ----------
  2071. .TP 18
  2072. .BR @fv (e1,e2,e3)
  2073. .IR @fv (100,.005,36)
  2074. computes the future value for of 36 monthly payments of $100 at 6% 
  2075. interest (.005 per month).  It answers the question: "How much
  2076. will I have in 36 months if I deposit $100 per month in a savings
  2077. account paying 6% interest compounded monthly?"
  2078. .\" ----------
  2079. .TP 18
  2080. .BR @pv (e1,e2,e3)
  2081. .IR @pv (1000,.015,36)
  2082. computes the present value of an a ordinary annuity of
  2083. 36 monthly payments of $1000 at 18% annual interest.
  2084. It answers the question: "How much can I borrow at 18% for 30 years
  2085. if I pay $1000 per month?"
  2086. .\" ==========
  2087. .SS "Built-in Date and Time Functions"
  2088. .\" ----------
  2089. Time for
  2090. .I sc
  2091. follows the system standard:
  2092. the number of seconds since 1970.
  2093. All date and time functions except
  2094. .IR @date ()
  2095. return numbers, not strings.
  2096. .\" ----------
  2097. .TP 18
  2098. .B @now
  2099. Return the current time encoded
  2100. as the number of seconds since the beginning of the
  2101. epoch (December 31, 1969, midnight, GMT.)
  2102. .\" ----------
  2103. .TP 18
  2104. .BR @dts (e1,e2,e3)
  2105. .IR @dts (9,14,1988)
  2106. converts the date September 14, 1988
  2107. to the number of seconds from the epoch
  2108. to the first second of 9/14/88, local time.
  2109. For example,
  2110. .IR @date ( @dts (12,14,1976))
  2111. yields
  2112. .IP ""
  2113. .I "    Tue Dec 14 00:00:00 1976"
  2114. .IP ""
  2115. The month should be range from  1 to 12, the day should range from
  2116. 1 to the number of days in the specified month, and the year should
  2117. range from 1970 to 1999.
  2118. .\" ----------
  2119. .TP 18
  2120. .BR @tts (e1,e2,e3)
  2121. .IR @tts (8,20,45)
  2122. converts the time 8:40:45 to the number of seconds since
  2123. midnight, the night before.  The hour should range from 0 to 23;
  2124. the minutes and seconds should range from 0 to 59.
  2125. .\" ----------
  2126. .PP
  2127. The following functions take the time in seconds
  2128. (e.g. from
  2129. .IR @now )
  2130. as an argument and return the specified value.
  2131. The functions all convert from GMT to local time.
  2132. .\" ----------
  2133. .TP 18
  2134. .BR @date (e)
  2135. Convert the time in seconds to a date string
  2136. 24 characters long in the following form:
  2137. .IP ""
  2138. .I "    Sun Sep 16 01:03:52 1973"
  2139. .IP ""
  2140. Note that you can extract parts of this fixed-format string with
  2141. .IR @substr ().
  2142. .\" ----------
  2143. .TP 18
  2144. .BR @year (e)
  2145. Return the year.
  2146. Valid years begin with 1970.
  2147. The last legal year is system dependent.
  2148. .\" ----------
  2149. .TP 18
  2150. .BR @month (e)
  2151. Return the month, encoded as 1 (January) to 12 (December).
  2152. .\" ----------
  2153. .TP 18
  2154. .BR @day (e)
  2155. Return the day of the month, encoded as 1 to 31.
  2156. .\" ----------
  2157. .TP 18
  2158. .BR @hour (e)
  2159. Return the number of hours since midnight, encoded as 0 to 23.
  2160. .\" ----------
  2161. .TP 18
  2162. .BR @minute (e)
  2163. Return the number of minutes since the last full hour, encoded as 0 to 59.
  2164. .\" ----------
  2165. .TP 18
  2166. .BR @second (e)
  2167. Return the number of seconds since the last full minute, encoded as 0 to 59.
  2168. .\" ==========
  2169. .SS "Spreadsheet Update"
  2170. .\" ----------
  2171. Re-evaluation of spreadsheet expressions
  2172. is done by row or by column depending on the selected calculation order.
  2173. Evaluation is repeated up to 
  2174. .I iterations
  2175. times for each update if necessary,
  2176. so forward references usually work as expected.  See
  2177. .I set
  2178. above.
  2179. If stability is not reached after ten iterations,
  2180. a warning is printed.
  2181. This is usually due to a long series of forward references,
  2182. or to unstable cyclic references (for example, set
  2183. .IR A0 's
  2184. expression to ``A0+1'').
  2185. .TP 18
  2186. .BR @numiter 
  2187. Returns the number of iterations performed so far.
  2188. .\" ==========
  2189. .SH FILES
  2190. .TP 4in
  2191. /sprite/lib/sc/tutorial.sc
  2192. tutorial spreadsheet
  2193. .SH SEE ALSO
  2194. bc(1), dc(1), crypt(1), psc(1)
  2195. .\" ==========
  2196. .SH BUGS
  2197. Top-to-bottom, left-to-right evaluation of expressions is silly.
  2198. A proper following of the dependency graph
  2199. with (perhaps) recourse to relaxation should be implemented.
  2200. .\" ----------
  2201. .PP
  2202. Only one previous value is saved from any call of
  2203. .IR @ext ().
  2204. If it is used more than once in a spreadsheet
  2205. and external functions are enabled and later disabled,
  2206. the last returned value pops up in several places.
  2207. .\" ----------
  2208. .PP
  2209. On some systems,
  2210. if the cell cursor is in column 0 with topline enabled
  2211. (so the current cell is highlighted),
  2212. or if any cell in column 0 is highlighted,
  2213. the corresponding row number gets displayed and then blanked
  2214. during a screen refresh.
  2215. This looks like a bug in
  2216. .IR curses .
  2217. .\" ----------
  2218. .PP
  2219. Many commands give no indication (a message or beep) if they have null effect.
  2220. Some should give confirmation of their action, but they don't.
  2221. .SH AUTHORS
  2222. This is a much modified version of a public domain spread sheet
  2223. originally authored by James Gosling,
  2224. and subsequently modified and posted to USENET by Mark Weiser under the name
  2225. .IR vc .
  2226. The program was subsequently renamed
  2227. .IR sc ,
  2228. and further modified by numerous contributors,
  2229. Jeff Buhrt
  2230. of Proslink, Inc.
  2231. ({sequent, uunet}!sawmill!prslnk!buhrt)
  2232. and Robert Bond of Sequent,
  2233. prominent among them.
  2234. Other contributors include:
  2235. Tom Anderson,
  2236. Glenn T. Barry,
  2237. Gregory Bond,
  2238. Stephen (Steve) M. Brooks,
  2239. Peter Brower,
  2240. John Campbell,
  2241. Lawrence Cipriani,
  2242. Jim Clausing,
  2243. Dave Close,
  2244. Chris Cole,
  2245. Jonathan Crompron,
  2246. David I. Dalva,
  2247. Glen Ditchfield,
  2248. Sam Drake,
  2249. James P. Dugal,
  2250. Paul Eggert,
  2251. Andy Fyfe,
  2252. Jack Goral,
  2253. Piercarlo "Peter" Grandi,
  2254. Henk Hesselink,
  2255. Jeffrey C Honig,
  2256. Kurt Horton,
  2257. Jonathan I. Kamens,
  2258. Peter King,
  2259. Tom Kloos,
  2260. Casey Leedom,
  2261. Jay Lepreau,
  2262. Dave Lewis,
  2263. Rick Linck,
  2264. Soren Lundsgaard,
  2265. Tad Mannes,
  2266. Rob McMahon,
  2267. Chris Metcalf,
  2268. Mark Nagel,
  2269. Ulf Noren,
  2270. Marius Olafsson,
  2271. Gene H. Olson,
  2272. Henk P. Penning,
  2273. Rick Perry,
  2274. Larry Philps,
  2275. Eric Putz,
  2276. Jim Richardson,
  2277. Michael Richardson,
  2278. R. P. C. Rodgers,
  2279. Kim Sanders,
  2280. Mike Schwartz,
  2281. Alan Silverstein,
  2282. Lowell Skoog,
  2283. Herr Soeryantono,
  2284. Tim Theisen,
  2285. Tom Tkacik,
  2286. Andy Valencia,
  2287. Adri Verhoef,
  2288. Rick Walker,
  2289. Petri Wessman,
  2290. and
  2291. Tim Wilson.
  2292. .\" end of man page
  2293.